package org.convallaria.system.biz.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.convallaria.infrastruct.db.mapper.BaseMapperX;
import org.convallaria.system.biz.entity.SysOperLog;

/**
 * 系统操作日志 Mapper 接口
 * 
 * 功能特性：
 * - 继承BaseMapperX，支持多表联查
 * - 支持批量操作的高性能实现
 * - 支持忽略逻辑删除的查询方法
 * - 提供统计和聚合查询方法
 * - 支持自定义SQL片段复用
 * 
 * 业务说明：
 * - 操作日志是系统安全审计的重要组成部分
 * - 支持多租户数据隔离
 * - 支持软删除机制
 * - 支持乐观锁并发控制
 * - 支持用户操作行为记录
 * - 支持操作状态管理
 * - 支持业务类型分类
 * - 支持操作类别分类
 * - 支持性能监控（消耗时间）
 * 
 * 关联关系：
 * - 与用户表：多对一关系，通过oper_name关联
 * - 与部门表：多对一关系，通过dept_name关联
 * - 与租户表：多对一关系，通过tenant_id关联
 * 
 * 数据约束：
 * - title：模块标题，可以为空
 * - business_type：业务类型，0-9之间的值
 * - operator_type：操作类别，0-2之间的值
 * - status：操作状态，0=正常，1=异常
 * - oper_time：操作时间，可以为空
 * - cost_time：消耗时间，可以为空
 * 
 * 数据安全：
 * - 支持操作日志数据权限控制
 * - 支持操作状态控制（正常/异常）
 * - 支持业务类型和操作类别分类
 * - 支持操作参数和结果记录
 * - 支持性能监控和优化
 * 
 * @author convallaria
 * @since 1.0.0
 */
@Mapper
public interface SysOperLogMapper extends BaseMapperX<SysOperLog> {

}
